<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
  <meta charset="utf-8" />
  <meta name="generator" content="pandoc" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
  <title>DFU-SUFFIX</title>
  <style type="text/css">
      code{white-space: pre-wrap;}
      span.smallcaps{font-variant: small-caps;}
      span.underline{text-decoration: underline;}
      div.column{display: inline-block; vertical-align: top; width: 50%;}
  </style>
</head>
<body>
<header id="title-block-header">
<h1 class="title">DFU-SUFFIX</h1>
<p class="date">September 2021</p>
</header>
<h1>NAME</h1>
<p>dfu-suffix - add, check, or remove DFU firmware file suffix</p>
<h1>SYNOPSIS</h1>
<p><strong>dfu-suffix</strong> [<em>options</em>] <strong>--add</strong> <em>DFU_FILE</em></p>
<p><strong>dfu-suffix</strong> <strong>--check</strong> <em>DFU_FILE</em></p>
<p><strong>dfu-suffix</strong> <strong>--delete</strong> <em>DFU_FILE</em></p>
<p><strong>dfu-suffix</strong> <strong>--help</strong></p>
<p><strong>dfu-suffix</strong> <strong>--version</strong></p>
<h1>DESCRIPTION</h1>
<p>The program <strong>dfu-suffix</strong> can be used to add, check or remove a DFU firmware file suffix, recommended for safely matching a firmware file and device.</p>
<p>Note that a suffix is recommended by the DFU standard, but not required. A DFU host tool like dfu-util will recognize the suffix and use it to check that the device is matching, but not transfer the suffix to the device.</p>
<h1>OPTIONS</h1>
<dl>
<dt><strong>-v, --vid <em>vendorID</em></strong></dt>
<dd><p>Specify USB vendor ID (hexadecimal)</p>
</dd>
<dt><strong>-p, --pid <em>productID</em></strong></dt>
<dd><p>Specify USB product ID (hexadecimal)</p>
</dd>
<dt><strong>-d, --did <em>deviceID</em></strong></dt>
<dd><p>Specify USB device ID (hexadecimal)</p>
</dd>
<dt><strong>-S, --spec <em>version</em></strong></dt>
<dd><p>Specify DFU specification version (hexadecimal)</p>
</dd>
<dt><strong>-h, --help</strong></dt>
<dd><p>Displays a help message.</p>
</dd>
<dt><strong>-V, --version</strong></dt>
<dd><p>Displays the software version.</p>
</dd>
</dl>
<h1>EXAMPLES</h1>
<dl>
<dt><strong><strong>dfu-suffix</strong> --vid 0123 --add firmware.dfu</strong></dt>
<dd><p>Adds a suffix matching vendor 0x0123 and product ID 0x4567. Since product and device ID are not specified, they will contain the wildcard value 0xFFFF.</p>
</dd>
<dt><strong><strong>dfu-suffix</strong> --check firmware.dfu</strong></dt>
<dd><p>Checks the file firmware.dfu for a valid DFU suffix</p>
</dd>
<dt><strong><strong>dfu-suffix</strong> --delete firmware.dfu</strong></dt>
<dd><p>Removes a valid DFU suffix from the file firmware.dfu</p>
</dd>
</dl>
<h1>EXIT VALUES</h1>
<dl>
<dt><strong><strong>0</strong></strong></dt>
<dd><p>Success (also if suffix is missing)</p>
</dd>
<dt><strong><strong>-64</strong></strong></dt>
<dd><p>Usage error</p>
</dd>
</dl>
<h1>LIMITATIONS</h1>
<p><strong>dfu-suffix</strong> can not tell a broken DFU suffix (e.g. checksum mismatch) from a non-existing suffix, so only a valid suffix can be removed.</p>
<h1>BUGS</h1>
<p>https://sourceforge.net/p/dfu-util/tickets/</p>
<h1>COPYRIGHT</h1>
<p>License GPLv2: GNU GPL version 2</p>
<h1>SEE ALSO</h1>
<p><strong>dfu-prefix</strong>(1), <strong>dfu-util</strong>(1)</p>
<h1>AUTHORS</h1>
<p>See AUTHORS file in source.</p>
</body>
</html>
